home *** CD-ROM | disk | FTP | other *** search
/ Aminet 24 / Aminet 24 (1998)(GTI - Schatztruhe)[!][Apr 1998].iso / Aminet / mus / play / PreludeAMP.lha / PreludeAMP.readme < prev   
Text File  |  1998-01-25  |  7KB  |  204 lines
  1. Short:    PPC MPEG audio player for Prelude
  2. Uploader: Thomas Wenzel (wenzel@unixserv.rz.fh-hannover.de)
  3. Author:   Thomas Wenzel (wenzel@unixserv.rz.fh-hannover.de)
  4. Type:     mus/play
  5. Version:  0.3
  6.  
  7. Introduction
  8. ------------
  9. PreludeAMP is an MPEG audio player based on Tomislav Uzelac's
  10. amp decoding engine. PreludeAMP is a standalone ELF binary for
  11. PowerUP.
  12.  
  13. Features
  14. --------
  15.  - FREEWARE!
  16.  - Compiled with SAS/C PowerPC Compiler 7.00
  17.  - Does not need ixemul.library!
  18.  - Does not need the AHI audio system
  19.  
  20. Requirements
  21. ------------
  22.  - A Prelude soundcard (it won't run on anything else)
  23.  - prelude.library v2
  24.  - A PowerUP compatible system
  25.  - ppc.library v45
  26.  - Runelf from the SAS/C package (also included in many PPC applications)
  27.  
  28. Usage
  29. -----
  30. Well, this is version 0.3, so don't expect too much :)
  31. It's only a commandline version and there are no options at all. You can
  32. pass exactly _one_ filename on the command line and that's it. If something
  33. goes wrong it may crash - beware!
  34.  
  35. History
  36. -------
  37. v0.1 - first working version :-)
  38.  
  39. v0.2 - improved error detection and ctrl-c support
  40.  
  41. v0.3 - inlined all functions that should be inlined according to the source
  42.        first public release
  43.  
  44. Legal stuff
  45. -----------
  46. PreludeAMP is copyrighted freeware. It may be distributed freely as long as
  47. no modifications are made to the executable and this document. A nominal
  48. fee may be asked to cover distribution costs.
  49.  
  50. PreludeAMP may not be used for any commercial purposes or included with any
  51. commercial product without the written permission of the author. It may
  52. NOT be stored on ftp servers or websites that also hold commercial software
  53. products or drivers for commercial hardware. The only exception are servers
  54. of the Aminet archive.
  55.  
  56. No responsibilities are taken for damaged speakers, amplifiers, Amigas
  57. or any other components or data involved while using PreludeAMP.
  58.  
  59. Although I've done some beta testing I can't guarantee that PreludeAMP will
  60. not crash! If you find any bugs, let me know.
  61.  
  62.  
  63. Here's the original amp.readme:
  64. -------------------------------
  65. amp MPEG audio decoder readme file (version 0.7.5)
  66. (C) Tomislav Uzelac  1996,1997
  67.  
  68. amp is free software and can be _used_ freely by anyone. If you want to
  69. do anything else with it, be sure to check the Legal section of this
  70. document for legal issues.
  71.  
  72. THERE IS NO WARRANTY FOR THIS PROGRAM. Please check out the Legal section
  73. of this document.
  74.  
  75. 1. Introduction
  76. 2. Installation
  77. 3. Running
  78. 4. Feedback
  79. 5. Contributing
  80. 6. Legal
  81.  
  82.  
  83. 1. Introduction
  84.  
  85. amp (Audio Mpeg Player) is an MPEG audio decoder which I originally started 
  86. putting together as a side project of the MPEG hardware design project at 
  87. FER/Zagreb - just to confirm my knowledge of the standard. It works with
  88. both MPEG1 and MPEG2 audio streams (except for the multichannel extensions
  89. defined in MPEG2), layers 2 and 3. 
  90.  
  91. There is a gui for amp, written in Tcl/Tk by Edouard Lafargue. It is 
  92. available at the amp home site ftp://ftp.rasip.fer.hr
  93.  
  94. Another gui supported is the Sajber Jukebox, written by Joel Lindholm.
  95.  
  96. The following people contributed their time and knowledge to amp:
  97. Karl Anders Oygard, Ilkka Karvinen, Lutz Vieweg, Dan Nelson,
  98. Edouard Lafargue, Andrew Richards, George Colouris,
  99. Dmitry Boldyrev, Andy Lo A Foe, Thomas Sailer, Justin Frankel
  100.  
  101. amp home location is
  102.     ftp://ftp.rasip.fer.hr/pub/mpeg/
  103.  
  104. and the mailing list: send 'HELP' in the body of the message to:
  105.     multimedia@rasip.fer.hr
  106.  
  107. If you want to find out more about MPEG, best places to start are
  108.     http://www.mpeg.org
  109.     http://www.mpeg2.de 
  110.  
  111.  
  112. 2. Installation
  113.  
  114. Installation should be simple enough if amp was ported to your system,
  115. just do a 
  116.  
  117. ./configure
  118. make 
  119.  
  120. You can edit the makefile further to suit your system. If configure fails 
  121. to make a usable Makefile, you'll _have_ to edit it yourself.
  122.  
  123. Linux users should try real-time playing support, as described
  124. in doc/realtime.txt. Some people that might pass on this feature are
  125. those with slower machines (i.e. 486's), or SMP systems (see the
  126. doc/linuxrealtime.txt file). 
  127. Some versions of the linux C library produce an error when compiling
  128. amp with realtime support. A quick fix is to edit /usr/include/sched.h
  129. and replace _P in the offending line with __P.
  130.  
  131. ./configure --enable-realtime
  132. make
  133. chown root.root amp
  134. chmod u+s amp
  135.  
  136. ... this requires /dev/dsp to be both world readable and writeable. If you
  137. have a special group for people allowed to use the sound device (for
  138. instance, a group called sound), you can do a:
  139.  
  140. chmod g+s amp
  141.  
  142. or make your audio card world read/writeable (not recomended)
  143.  
  144. chmod o+rw /dev/dsp*
  145.  
  146. 3. Running:
  147.  
  148. 'amp -h' gives you usage & options. If your computer is on the slower
  149. side, direct playback might not work, but you can decode it
  150. to .wav or raw pcm and play it later.
  151.  
  152.  
  153. 4. Feedback
  154.  
  155. Send in your makefiles, opinions, bugreports, fixes; anything related to this
  156. program. You can also send me unlimited amounts of money, sugar, milk, etc.
  157.  
  158. If you find any mpeg audio files that amp has trouble decoding, please tell
  159. me about this via e-mail <tuzelac@rasip.fer.hr>.
  160.  
  161.  
  162. 5. Contributing
  163.  
  164. Please contribute to amp. If you want to know what is going on in amp 
  165. development, you can join the developers mailing list
  166.  
  167.     mpeg_audio_developers@rasip.fer.hr
  168.  
  169. There are certain debugging facilities that I made in amp, but are disabled
  170. in the current release (they are neither nice nor user-friendly). If anyone
  171. enhances them (they are in dump.c) to the point that they're actually
  172. usable I'll be happy to include the changes in the release. I think this
  173. kind of debug output would be very useful to people studying these audio
  174. algorithms.
  175.  
  176.  
  177. 6. Legal
  178.  
  179. This software can be used freely for any purpose. It can be distributed
  180. freely, as long as it is not sold commercially without permission from
  181. Tomislav Uzelac <tuzelac@rasip.fer.hr>. However, including this software
  182. on CD_ROMs containing other free software is explicitly permitted even 
  183. when a modest distribution fee is charged for the CD, as long as this
  184. software is not a primary selling argument for the CD.
  185.  
  186. Building derived versions of this software is permitted, as long as they
  187. are not sold commercially without permission from Tomislav Uzelac 
  188. <tuzelac@rasip.fer.hr>. Any derived versions must be clearly marked as
  189. such, and must be called by a name other than amp. Any derived versions
  190. must retain this copyright notice.
  191.  
  192. /* This license is itself copied from Tatu Ylonen's ssh package. It does 
  193.  * not mention being copyrighted itself :)
  194.  */
  195.  
  196. THERE IS NO WARRANTY FOR THIS PROGRAM - whatsoever. You use it entirely
  197. at your risk, and neither Tomislav Uzelac, nor FER will be liable for
  198. any damages that might occur to your computer, software, etc. in
  199. consequence of you using this freeware program.
  200.  
  201.  
  202. Tomislav Uzelac
  203. <tuzelac@rasip.fer.hr>
  204.